home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / archie.1 < prev    next >
Text File  |  1995-07-25  |  13KB  |  265 lines
  1.  
  2.  
  3.  
  4.      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))      AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((22226666 OOOOccccttttoooobbbbeeeerrrr 1111999999992222))))      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           archie - query the Archie anonymous FTP databases using
  10.           Prospero
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           aaaarrrrcccchhhhiiiieeee [[[[ ----cccceeeerrrrssss ] [ ----aaaa ] [ ----llll ] [ ----tttt ] [ ----mmmm _h_i_t_s ]
  14.                  [ ----NNNN [[[[ _l_e_v_e_l ] ] [ ----hhhh _h_o_s_t_n_a_m_e ] [ ----oooo _f_i_l_e_n_a_m_e ]
  15.                  [ ----LLLL ] [ ----VVVV ] [ ----vvvv ] _s_t_r_i_n_g
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           aaaarrrrcccchhhhiiiieeee queries an archie anonymous FTP database looking for
  19.           the specified _s_t_r_i_n_g using the PPPPrrrroooossssppppeeeerrrroooo protocol.  This
  20.           client is based on PPPPrrrroooossssppppeeeerrrroooo version Beta.4.2 and is provided
  21.           to encourage non-interactive use of the Archie servers (and
  22.           subsequently better performance on both sides).  This man
  23.           page describes version 1.3 of the client.
  24.  
  25.           The general method of use is of the form
  26.  
  27.                % aaaarrrrcccchhhhiiiieeee ssssttttrrrriiiinnnngggg
  28.  
  29.           This will go to the archie server and ask it to look for all
  30.           known systems that have a file named `string' in their FTP
  31.           area.  aaaarrrrcccchhhhiiiieeee will wait, and print out any matches.
  32.  
  33.           For example,
  34.  
  35.                % aaaarrrrcccchhhhiiiieeee eeeemmmmaaaaccccssss
  36.  
  37.           will find all anonymous FTP sites in the archie database
  38.           that have files named eeeemmmmaaaaccccssss somewhere in their FTP area.
  39.           (This particular query would probably return a lot of
  40.           directories.)  If you want a list of every filename that
  41.           contains eeeemmmmaaaaccccssss _a_n_y_w_h_e_r_e in it, you'd use
  42.  
  43.                % aaaarrrrcccchhhhiiiieeee ----cccc eeeemmmmaaaaccccssss
  44.  
  45.           Regular expressions, such as
  46.  
  47.                % aaaarrrrcccchhhhiiiieeee ----rrrr ''''[[[[xxxxXXXX]]]][[[[llllLLLL]]]]iiiisssspppp''''
  48.  
  49.           may also be used for searches.  (See the manual of a
  50.           reasonably good editor, like GNU Emacs or vi, for more
  51.           information on using regular expressions.)
  52.  
  53.  
  54.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  55.           The options currently available to this aaaarrrrcccchhhhiiiieeee client are:
  56.  
  57.           ----cccc          Search substrings paying attention to upper &
  58.                       lower case.
  59.           ----eeee          Exact string match.  (This is the default.)
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/30/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))      AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((22226666 OOOOccccttttoooobbbbeeeerrrr 1111999999992222))))      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))
  71.  
  72.  
  73.  
  74.           ----rrrr          Search using a regular expression.
  75.           ----ssss          Search substrings ignoring the case of the
  76.                       letters.
  77.           ----oooo_f_i_l_e_n_a_m_e  If specified, place the results of the search in
  78.                       _f_i_l_e_n_a_m_e.
  79.           ----aaaa          Output results as Alex filenames.
  80.           ----llll          Output results in a form suitable for parsing by
  81.                       programs.
  82.           ----tttt          Sort the results inverted by date.
  83.           ----mmmm_h_i_t_s      Specifies the maximum number of hits (matches)
  84.                       to return (default of 99995555).
  85.           ----NNNN_l_e_v_e_l     Sets the _n_i_c_e_n_e_s_s of a query; by default, it's
  86.                       set to 0.  Without an argument, ``-N'' defaults
  87.                       to 33335555777766665555.  If you use ----NNNN with an argument
  88.                       between 0 and 35765, it'll adjust itself
  89.                       accordingly.  (NNNNooootttteeee: VMS users will have to put
  90.                       quotes around this argument, and ----LLLL, like
  91.                       "----NNNN44445555"; VMS will otherwise convert it to
  92.                       lowercase.)
  93.           ----hhhh _h_o_s_t_n_a_m_e Tells the client to query the Archie server
  94.                       _h_o_s_t_n_a_m_e.
  95.           ----LLLL          Lists the Archie servers known to the program
  96.                       when it was compiled, as well as the name of the
  97.                       default Archie server.  For an up-to-date list,
  98.                       write to ``archie@archie.mcgill.ca'' (or any
  99.                       Archie server) with the single command of
  100.                       _s_e_r_v_e_r_s.
  101.           ----VVVV          With the verbose option, aaaarrrrcccchhhhiiiieeee will make some
  102.                       comments along the way if a search is going to
  103.                       take some time, to pacify the user.
  104.  
  105.           The three search-modifying arguments (``-c'', ``-r'', and
  106.           ``-s'') are all mutually exclusive; only the last one
  107.           counts.  If you specify ----eeee with any of ``-c'', ``-r'', or
  108.           ``-s'', the server will first check for an exact match, then
  109.           fall back to the case-sensitive, case-insensitive, or
  110.           regular expression search.  This is so if there are matches
  111.           that are particularly obvious, it will take a minimal amount
  112.           of time to satisfy your request.
  113.  
  114.           If you list a single `-' by itself, any further arguments
  115.           will be taken as part of the search string.  This is
  116.           intended to enable searching for strings that begin with a
  117.           `-'; for example:
  118.  
  119.                % aaaarrrrcccchhhhiiiieeee ----ssss ---- ----oooolllldddd
  120.  
  121.           will search for all filenames that contain the string `-old'
  122.           in them.
  123.  
  124.      RRRREEEESSSSPPPPOOOONNNNSSSSEEEE
  125.           Archie servers are set up to respond to a number of requests
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/30/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))      AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((22226666 OOOOccccttttoooobbbbeeeerrrr 1111999999992222))))      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))
  137.  
  138.  
  139.  
  140.           in a queued fashion.  That is, smaller requests get served
  141.           much more quickly than do large requests.  As a result, the
  142.           more often you query the Archie server, or the larger your
  143.           requests, the longer the queue will become, resulting in a
  144.           longer waiting period for everyone's requests.  Please be
  145.           frugal when possible, for your benefit as well as for the
  146.           other users.
  147.  
  148.      QQQQUUUUEEEERRRRYYYY PPPPRRRRIIIIOOOORRRRIIIITTTTYYYY
  149.           Please use the ``-N'' option whenever you don't demand
  150.           immediacy, or when you're requesting things that could
  151.           generate large responses.  Even when using the nice option,
  152.           you should still try to avoid big jobs during busy periods.
  153.           Here is a list of what we consider to be nice values that
  154.           accurately reflect the priority of a job to the server.
  155.  
  156.                NNNNoooorrrrmmmmaaaallll              0
  157.                NNNNiiiicccceeee                500
  158.                NNNNiiiicccceeeerrrr               1000
  159.                VVVVeeeerrrryyyy NNNNiiiicccceeee           5000
  160.                EEEExxxxttttrrrreeeemmmmeeeellllyyyy NNNNiiiicccceeee      10000
  161.                NNNNiiiicccceeeesssstttt              32765
  162.  
  163.           The last priority, NNNNiiiicccceeeesssstttt, would be used when a job should
  164.           wait until the queue is essentially empty before running.
  165.           You should pick one of these values to use, possibly
  166.           modifying it slightly depending on where you think your
  167.           priority should land.  For example, 32760 would mean wait
  168.           until the queue is empty, but jump ahead of other jobs that
  169.           have selected NNNNiiiicccceeeesssstttt.
  170.  
  171.           There are certain types of things that we suggest using
  172.           NNNNiiiicccceeeesssstttt for, irregardless.  In particular, any searches for
  173.           which you would have a hard time justifying the use of
  174.           anything but extra resources.  (We all know what those
  175.           searches would be for.)
  176.  
  177.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  178.           ARCHIE_HOST
  179.                   This will change the host _a_r_c_h_i_e will consult when
  180.                   making queries.  (The default value is what's been
  181.                   compiled in.)  The ``-h'' option will override this.
  182.                   If you're running VMS, create a symbol called
  183.                   ARCHIE_HOST.
  184.  
  185.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  186.           For more information on regular expressions, see the manual
  187.           pages on:
  188.  
  189.           rrrreeeeggggeeeexxxx(3),,,, eeeedddd(1)
  190.  
  191.           Also read the file aaaarrrrcccchhhhiiiieeee////ddddoooocccc////wwwwhhhhaaaattttiiiissss....aaaarrrrcccchhhhiiiieeee on
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/30/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))      AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((22226666 OOOOccccttttoooobbbbeeeerrrr 1111999999992222))))      AAAARRRRCCCCHHHHIIIIEEEE((((1111))))
  203.  
  204.  
  205.  
  206.           aaaarrrrcccchhhhiiiieeee....mmmmccccggggiiiillllllll....ccccaaaa for a detailed paper on Archie as a whole.
  207.  
  208.           Read the file README.ALEX distributed with this client for
  209.           more information on what Alex is and how you can take
  210.           advantage of it.
  211.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  212.           The aaaarrrrcccchhhhiiiieeee service was conceived and implemented by Alan
  213.           Emtage (bbbbaaaajjjjaaaannnn@@@@ccccssss....mmmmccccggggiiiillllllll....ccccaaaa), Peter Deutsch
  214.           (ppppeeeetttteeeerrrrdddd@@@@ccccssss....mmmmccccggggiiiillllllll....ccccaaaa), and Bill Heelan
  215.           (wwwwhhhheeeeeeeellllaaaannnn@@@@ccccssss....mmmmccccggggiiiillllllll....ccccaaaa).  The entire Internet is in their
  216.           debt.
  217.  
  218.           The PPPPrrrroooossssppppeeeerrrroooo system was created by Clifford Neuman
  219.           (bbbbccccnnnn@@@@iiiissssiiii....eeeedddduuuu); write to iiiinnnnffffoooo----pppprrrroooossssppppeeeerrrroooo@@@@iiiissssiiii....eeeedddduuuu for more
  220.           information on the protocol and its use.
  221.  
  222.           This stripped client was put together by Brendan Kehoe
  223.           (bbbbrrrreeeennnnddddaaaannnn@@@@ccccyyyyggggnnnnuuuussss....ccccoooommmm), with modifications by Clifford Neuman
  224.           and George Ferguson (ffffeeeerrrrgggguuuussssoooonnnn@@@@ccccssss....rrrroooocccchhhheeeesssstttteeeerrrr....eeeedddduuuu).
  225.  
  226.      BBBBUUUUGGGGSSSS
  227.           There are none; only a few unexpected features.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 6/30/95)
  262.  
  263.  
  264.  
  265.